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Chapter 1. Overview 


Chapter 1. Overview 


SecuGen's FDx SDK Pro is designed to provide low level access to SecuGen's fingerprint readers using 
SecuGen's next-generation algorithm module. Programming with SecuGen's FDx SDK Pro is simple and 
easy to program and gives the most development flexibility among all SecuGen SDKs. 


1.1. Features 

• Uses SecuGen's new and improved next-generation algorithms 

• Supports three kinds of fingerprint minutiae formats (or templates): 

o SG400: SecuGen's proprietary fingerprint minutiae format 
o ANSI378: Finger Minutiae Format for Data Exchange (ANSI-INCITS 378-2004) 
o IS019794-2: Biometric Data Interchange Formats--Finger Minutiae Data (ISO/IEC 19794- 
2:2005) 

• Provides low-level APIs for image capture, feature extraction and matching 

• The following extraction and matching algorithms, which are incorporated in libsgfpamx.so in this 
SDK, support the ANSI-INCITS 378-2004 standard and have been tested and proven to be MINEX 
Compliant ( http://fingerprint.nist.gov/MINEX/ ): 

o SecuGen ANSI INCITS 378 Template Generator v3.5 (feature extraction algorithm) 
o SecuGen ANSI INCITS 378 Template Matcher v3.5 (matching algorithm) 

• Gives a high degree of flexibility to developers of all kinds of applications and is easy to use 


1.2. System Requirements 

The SecuGen fingerprint reader captures a fingerprint image that is digitized to an 8-bit gray-scale image 
at 500 DPI resolution. The host system then retrieves the image through its USB port for subsequent 
processing. Supported SecuGen USB fingerprint readers and sensors: 

• FDU03 sensor class : Flamster Plus and FDU03FR, FDU03FRS, SDU03M, or SDU03P sensors 

• FDU04 sensor class : Flamster IV and FDU04 or SDU04P sensors 

• FDU05 sensor class : Flamster Pro 20 and U20 sensors 

• FDU06-sensor class : Flamster Pro and UPx sensors 

• FDU07-sensor class : Flamster Pro 10 and U10 sensors 

System requirements: 

• IBM-compatible PC 486 or later 

• 1 USB port (USB 2.0 required for FDU04, U20 and UPx-class readers) 

• 64 MB RAM 

• 80 MB available hard disk space 

• Linux Kernel 2.6 
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Chapter 2. Installation 

2.1. Installation 

1. Unzip the FDx SDK Pro for UNIX/LINUX on your system. 

2. Change directory to <installdir>/lib/target and run "make uninstall install" 


2.2. Included Files 

After unzipping the FDx SDK Pro for UNIX/LINUX, the following files are copied to your extraction directory 
(installdir). 


<installdir>/readme.txt Latest information about current release 


<installdir>/lib/target 

Iibsgfdu03.so 

Iibsgfdu04.so 

Iibsgfdu05.so 

Iibsgfdu06.so 

Iibsgfdu07.so 

libsgfpamx.so 

libsgfplib.so 

Makefile 


Runtime libraries 
FDU03 device driver 
FDU04 device driver 
FDU05 device driver 
FDU06 device driver 
FDU07 device driver 

Fingerprint algorithm module for extraction & matching (MINEX Compliant) 
Main module 

Makefile to install library files 


<installdir>/bin/target directory 


Demo applications linked with either FDU03, FDU04, FDU05 or FDU06 shared libraries 


auto on fdu03 

Demo console application for auto 
on using: 

Hamster Plus 

auto on fdu04 

Hamster IV 

auto on fdu05 

Hamster Pro 20 

auto on fdu06 

Hamster Pro 

auto on fdu07 

Hamster Pro 10 

fpmatcher fdu03 

GTK+ Demo program forfingerprint 
capture, extract and match using: 

Hamster Plus 

fpmatcher fdu04 

Hamster IV 

fpmatcher fdu05 

Hamster Pro 20 

fpmatcher fdu06 

Hamster Pro 

fpmatcher fdu07 

Hamster Pro 10 

multidev fdu03 

Demo console application for 
multiple device test using: 

Hamster Plus 

multidev fdu04 

Hamster IV 

multidev fdu05 

Hamster Pro 20 

multidev fdu06 

Hamster Pro 

multidev fdu07 

Hamster Pro 10 

sgd2_fdu03 


Hamster Plus 
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sgd2 fdu04 

GTK+ Demo program forfingerprint 
capture using: 

Hamster IV 

sgd2 fdu05 

Hamster Pro 20 

sgd2 fdu06 

Hamster Pro 

sgd2 fdu07 

Hamster Pro 10 

sgfplibtest fdu03 

Demo console application for 
fingerprint capture, extract and 
match using: 

Hamster Plus 

sgfplibtest fdu04 

Hamster IV 

sgfplibtest fdu05 

Hamster Pro 20 

sgfplibtest fdu06 

Hamster Pro 

sgfplibtest fdu07 

Hamster Pro 10 

test auto on fdu03 

Driver console application for auto 
on fingerprint capture using: 

Hamster Plus 

test auto on fdu04 

Hamster IV 

test auto on fdu05 

Hamster Pro 20 

test auto on fdu06 

Hamster Pro 

test auto on fdu07 

Hamster Pro 10 

test fdu03 

Driver console application for 
fingerprint capture using: 

Hamster Plus 

test fdu04 

Hamster IV 

test fdu05 

Hamster Pro 20 

test fdu06 

Hamster Pro 

test_fdu07 

Hamster Pro 10 


<installdir>/include directory SDK library header file 

sgfplib.h Declarations of function prototypes and structures used in the SDK 


<installdir>/sgfplibtest 

<installdir>/sgd2 

<installdir>/fpmatcher 


Sample source code for sgfplibtest 
Sample source code for sgd2 
Sample source code for fpmatcher 


/usr/local/lib 

Runtime modules installed by running "make uninstall install" in <installdir>/lib/target 


Iibsgfdu03.so 

iibsgfdu04.so 

Iibsgfdu05.so 

Iibsgfdu06.so 

Iibsgfdu07.so 

libsgfpamx.so 

libsgfplib.so 


FDU03 device driver (Hamster Plus) 

FDU04 device driver (Hamster IV) 

FDU05 device driver (Hamster Pro 20) 

FDU06 device driver (Hamster Pro) 

FDU07 device driver (Hamster Pro 10) 

MINEX compliant fingerprint algorithm module for extraction & matching 
Main module 
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Chapter 3. Programming in C/C++ 


Chapter 3. Programming in C/C++ 


SecuGen's FDx SDK Pro was designed for ease in programming and most flexibility for developers. All SDK 
functions are integrated into the SGFPM (SecuGen FingerPrint Module) class. The SGFPM class includes 
device initialization, fingerprint capture, minutiae extraction and matching functions. The developer can 
access SDK functions directly through the SGFPM class or through C functions that wrap the SGFPM class. 
C functions provide access to SDK functionalities through an SGFPM handle. In this chapter, C functions 
are explained. For direct access to the SGFPM class, refer to Appendix A . 


3.1. Creating SGFPM 

To use SGFPM, call SGFPM_Create(), which creates an SGFPM object and returns a handle to the SGFPM 
object. When calling SGFPM_Create(), pass a pointer to the handle to contain the SGFPM handle as a 
parameter. The SGFPM handle is used for the duration of the session to access other functions. 


HSGFPM m_hFPM; // handle for SGFPM 
DWORD err = SGFPM_Create(&m_hFPM); 

3.2. Initializing SGFPM 

If an SGFPM object is created, it should be initialized using SGFPM_lnit{) or SGFPM_lnitEx(). SGFPM_lnit{) 
takes the device name, loads the driver that corresponds to the device name and initializes the fingerprint 
algorithm module based on device information. SGFPM_lnitEx() takes image width, image height and 
resolution as parameters. Call SGFPM_lnitEx() when using the fingerprint algorithm module without a 
SecuGen reader. 


The table below summarizes the correlation among device name (device type), loaded device driver and 
initial image size when the lnit(SGFPMDeviceName devName) function is called. 


Device Name, Device Driver and Image Size 


Device Name 

Value 

Device driver 

Image Size (pixels) 

SGDEV FDU03 

4 

FDU03 / SDU03 USB driver 

260*300 

SGDEV FDU04 

5 

FDU04 / SDU04 USB driver 

258*336 

SGDEV FDU05 

6 

U20 USB driver 

300*400 

SGDEV_FDU06 

7 

UPx USB driver 

260*300 
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SGDEV_FDU07 

8 

U10 USB driver 

252*330 


• SGFPM_lnit{) 

DWORD devname = SG_DEV_FDU03; 
err = SGFPM Init(m hFPM, devname); 

• SGFPM_lnitEx() 


DWORD image width = 260; 

DWORD image height = 300; 

DOWRD image dpi = 500; 

err = SGFPM InitEx(m hFPM, image width, image height, image dpi); 

3.3. Terminating SGFPM 

SGFPM_Terminate() must be called prior to terminating the application. It frees up the memory used by 
the SGFPM object. 


if (m hFPM) 

{ 

SGFPM_Terminate(m_hFPM); 

} 

m hFPM = 0; 


3.4. Opening the SecuGen Fingerprint Reader 

To use a SecuGen fingerprint reader, call SGFPM_OpenDevice(). The second parameter (devld) of 
SGFPM_OpenDevice() can have different meanings depending on which type of fingerprint reader is used. 


For USB readers, devld means device ID. If only one USB fingerprint reader is connected to the PC, devld 
will be 0. If multiple USB fingerprint readers are connected to one PC, devld can range from 0 to 9. The 
maximum number of SecuGen USB readers that can be connected to one PC is 10. 


In general, if only one USB reader is connected to the PC, then 0 or USB_AUTO_DETECT is recommended. 


DWORD devld = USB_AUTO_DETECT; // auto detect 
err = SGFPM OpenDevice(m hFPM, devld); 
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3.5. Getting Device Information 

Device information can be retrieved by calling SGFPM_GetDevicelnfo(), which obtains required device 
information such as image height and width. The device information is contained in the 
SGDevicelnfoParam structure. Refer to Chapter 5. Structure Reference for a detailed description of the 

SGDevicelnfoParam structure. 


SGDevicelnfoParam device info; 

memset(&device info, 0x00, sizeof(device info)); 
error = SGFPM GetDevicelnfo(m hFPM, &device info); 

if (error == SGSGFDX_ERROR_NONE) 

{ 

m DevID = device info.DevicelD; 

m DevSN = device info.DeviceSN; 
m ImgWidth = device info.ImageWidth; 
m ImgHeight = device info.ImageHeight; 
m Contrast = device info.Contrast; 
m Brightness = device info.Brightness; 
m Gain = device info.Gain; 
m ImageDPI = device info.ImageDPI; 
char buffer [20]; 

ultoa(device info.FWVersion, buffer, 16); 
m FWVersion = CString(buffer); 

} 


3.6. Capturing a Fingerprint Image 

After the reader is initialized, a fingerprint image can be captured. The SGFPM object provides three types 
of fingerprint image capture functions listed below. Captured fingerprints are 256 gray-level images, and 
image width and height can be retrieved by calling SGFPM_GetDevicelnfo(). The image buffer should be 
allocated by the calling application. 


SGFPM_Getlmage() captures an image without checking for the presence of a finger or checking image 
quality. SGFPM_GetlmageEx() captures fingerprint images continuously, checks the image quality against 
a specified quality value and ignores the image if it does not contain a fingerprint or if the quality of the 
fingerprint is not acceptable. If a quality image is captured within the given time (the second parameter), 
SGFPM_GetlmageEx() ends its processing. If a window handle is provided by the application, the drivers 
will draw a fingerprint image in the provided window using the handle value. 


For more information about each of the following SGFPM image capture functions, refer to Chapter 4. 
Function Reference. 
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• SGFPM_Getlmage() 


[Example] 

BYTE *buffer = new BYTE(m ImageWidth*m ImageHeight); 

if (SGFPM_GetImage(m_hFPM, buffer) == SGSGFDX_ERROR_NONE) // Get 

image data from device 

{ 

// Display image 
// Process image 

} 

delete [] buffer; 

• SGFPM_GetlmageEx() 


DWORD timeout = 10000; 

DWORD quality = 80; 

if(SGFPM GetlmageEx(m hFPM, buffer, timeout, NULL, quality) == 
SGFDX_ERROR_NONE) 

{ 

// Draw image 

} 


3.7. Getting Image Quality 

To determine the fingerprint image quality, use GetlmageQualityQ. 


• SGFPM_GetlmageQuality() 


DWORD img qlty; 

SGFPM GetlmageQuality(hFPM, ImageWidth, m ImageHeight, fp image, 
&mg_qlty); 

if (img_qlty < 80) 

// Capture again 
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3.8. Controlling Brightness 

Depending on the fingerprint reader used, environmental factors and the specifications of the host 
system, the brightness of a fingerprint image may vary. To improve the quality of a captured image, the 
image brightness should be adjusted by changing the brightness setting of the reader using 
SGFPM_Configure() or SGFPM_SetBrightness(). Using SGFPM_Configure() presents a built-in dialog box 
in the driver from which the user can easily adjust brightness and receive instant feedback from the 
fingerprint image displayed. SGFPM_SetBrightness() can also be used to control brightness of the reader. 
Brightness default values vary among the different types of SecuGen readers. 


• SGFPM_Configure() 


HWND hwnd = 0; 

SGFPM SetBrightness(m hFPM, hwnd); // Show device configuration 

box in the driver. 


• SGFPM_ SetBrightness() 


SGFPM SetBrightness(m hFPM, 70); // Set from 0 to 100. 

3.9. Creating a Template 

To register or verify a fingerprint, a fingerprint image is first captured, and then feature data (minutiae) is 
extracted from the image into a template. Minutiae are the unique core points near the center of every 
fingerprint, such as ridges, ridge endings, bifurcations, valleys and whorls. 


Use SGFPM_CreateTemplate() to extract minutiae from a fingerprint image to form a template. The 
buffer should be assigned by the application. To get the buffer size of the minutiae, call 
SGFPM_GetMaxTemplateSize(). It will return the maximum buffer size for data in one template. The 
actual template size can be obtained by calling SGFPM_GetTemplateSize() after the template is created. 
The SGFPM_CreateTemplate() API creates only one set of data from an image. 


Note: Templates having the ANSI378 or IS019794-2 format may be merged. For more information about 
template formats, refer to Section 3.15. Template Format . For more information about merging 
templates, refer to Section 3.16. Manipulating ANSI378 Templates and Section 3.17. Manipulating 
ISQ19794-2 Templates . 
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• SGFPM_CreateTemplate() 


// Get a fingerprint image 
DWORD qlty = 80; 

err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, qlty); 

// Create template from captured image 
BYTE* minBuffer; 

err = SGFPM GetMaxTemplateSize(m hFPM, &maxTemplateSize); 
minBuffer = new BYTE[maxTemplateSize]; 

// Set information about template 
SGFingerlnfo finger info; 

finger info.FingerNumber = GetFingerPos(); 
finger info.ImageQuality = (WORD)qlty; 
finger info.ImpressionType = SG IMPTYPE LP; 
finger info.ViewNumber = 1; 

err = SGFPM_CreateTemplate(m hFPM, &finger info, m ImgBuf, 
minBuffer); 

3.10. Matching Templates 

Templates are matched during both registration and verification processes. During registration, it is 
recommended to capture at least two image samples per fingerprint for a higher degree of accuracy. The 
minutiae data from each image sample can then be compared against each other (i.e. matched) to confirm 
the quality of the registered fingerprints. This comparison is analogous to a password confirmation routine 
that is commonly required for entering a new password. 


During verification, newly input minutiae data is compared against registered minutiae data. Similar to 
the registration process, verification requires the capture of a fingerprint image followed by extraction of 
the minutiae data from the captured image into a template. 


To match templates, the FDx SDK Pro provides four kinds of matching functions. Each function requires 
two sets of template data for matching. 


SGFPM_MatchTemplate():This function matches templates having the same format as the default 
format. When calling this function, each template should include only one sample (or view) per template. 
The default format is SG400 (SecuGen proprietary format) but can be changed by calling 
SGFPM_SetTemplateFormat(). For more information about template formats, refer to Section 3.15. 

Template Format . 
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SGFPM_MatchTemplateEx(): This function can match templates having different template formats. This 
function can also specify the template format for each template and can match templates that have 
multiple views per template. 


SGFPM_MatchAnsiTemplate(): This function is the same as SGFPM_MatchTemplateEx() except that it 
supports only ANSI378 templates. 


SGFPM_MatchlsoTemplate(): This fucntion is the same as SGFPM_MatchTemplateEx() except that it 
supports only IS019794-2 templates. 


Function 

Template Format 

Can match templates with 
different template formats? 

SGFPM MatchTemplate 

SG400 (System default) 

No 

SGFPM MatchTemplateEx 

Specified template format 

Yes 

SGFPM MatchAnsiTemplate 

ANSI378 

No 

SGFPM_MatchlsoTemplate 

IS019794-2 

No 


• SGFPM_MatchTemplate() 


BYTE* m RegTemplatel; 

BYTE* m RegTemplate2; 

// Getfirst fingerprint image and create template from the image 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, qlty); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplatel); 

// Get second fingerprint image and create template from the image 

err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, qlty); 

err = SGFPM CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplate2); 

DWORD si = SL_NORMAL; // Set security level as NORMAL 

BOOL matched; 

err = SGFPM MatchTemplate(m hFPM, m RegTemplatel, m 
RegTemplate2, si, &matched); 
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• SGFPM_MatchTemplateEx() 


BYTE* m RegTemplatel; // Will contain SG400 template 

BYTE* m RegTemplate2; // Will contain ANSI378 template 

// Make SG400 template 

err = SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_FORMAT_SG400); 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, qlty); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplatel); 

// Make ANSI378 template 

err = SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_F0RMAT_ANSI378); 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, qlty); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplate2); 

DWORD si = SL_NORMAL; // Set security level as NORMAL 

BOOL matched; 

err = SGFPM MatchTemplateEx(m hFPM, m RegTemplatel, 

TEMPLATE_FORMAT_SG4 00, 

0, // Must be 0 if template format is SG400 

m RegTemplate2, 

TEMPLATE_F0RMAT_ANSI37 8, 

0, // Currently only one sample 

si, 

&matched); 


• SGFPM_MatchAnsiTemplate() 


DWORD err; 

BOOL matched = FALSE; 

SGANSITemplatelnfo sample info; 

err = SGFPM GetAnsiTemplatelnfo(m hFPM, m EnrollTemplate, 
&sample info); 

matched = TRUE; 

bool finger found = false; 

for (int i = 0; i < sample info.TotalSamples; i++) 

{ 

if(sample info.Samplelnfo[i].FingerNumber == finger pos) // Try 
match for same finger 
{ 

finger found = true; 

err = SGFPM MatchAnsiTemplate(m hFPM, m EnrollTemplate, i, 
m FetBufM, 0, SecurityLevel[m SecureLevel.GetCurSel()], Smatched); 
if (Imatched) 
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break; 


• SGFPM_MatchlsoTemplate() 


DWORD err; 

BOOL matched = FALSE; 

// IS019794-2 

SGISOTemplatelnfo sample info = {0}; 

err = SGFPM GetlsoTemplatelnfo(m hFPM, m StoredTemplate, 
&sample_info); 

matched = FALSE; 

int found finger = -1; 

for (int i = 0; i < sample info.TotalSamples; i++) 

{ 

// ISOl9794-2 

err = SGFPM MatchlsoTemplate(m hFPM, m StoredTemplate, i, 
m FetBufM, 0, SL NORMAL, &matched); 
if (matched) 

{ 

found finger = sample info.Samplelnfo[i].FingerNumber; 
break; 
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3.11. Registration process 

To register a fingerprint, a fingerprint image is first captured, and then feature data (minutiae) is extracted 
from the image into a template. It is recommended to capture at least two image samples per fingerprint 
for a higher degree of accuracy. The minutiae data from each image can then be compared against each 
other (i.e. matched) to confirm the quality of the registered fingerprints. This comparison is analogous to 
a password confirmation routine that is commonly required for entering a new password. 


Overview of Registration Process 

1. Capture fingerprint images: SGFPM_Getlmage() or SGFPM_GetlmageEx() 

2. Extract minutiae from each captured fingerprint image: SGFPM_CreateTemplate() 

3. Match each template to determine if they are acceptable for registration: 

SGFPM_MatchTemplate() 

4. Save templates to file or database to complete registration 


Example: Using two fingerprint images to register one fingerprint 


BYTE* m RegTemplatel; 

BYTE* m RegTemplate2; 

err = SGFPM GetMaxTemplateSize(m hFPM, &m MaxTemplateSize); 
m RegTemplatel = new BYTE[m MaxTemplateSize]; 
m RegTemplate2 = new BYTE[m MaxTemplateSize]; 

// Get first fingerprint image and create template from the image 

err = SGFPM GetlmageEx(m hFPM, m ImgBuf, 5000, NULL, qlty); 

err = SGFPM CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplatel); 

// Get second fingerprint image and create template from the image 

err = SGFPM GetlmageEx(m hFPM, m ImgBuf, 5000, NULL, qlty); 

err = SGFPM CreateTemplate(m hFPM, 0, m ImgBuf, m RegTemplate2); 

DWORD si = SL_NORMAL; // Set security level as NORMAL 
BOOL matched; 

err = SGFPM MatchTemplate(m hFPM, m RegTemplatel, m 
RegTemplate2, si, &matched); 

if (matched) 

// Save these templates somewhere 
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3.12. Verification Process 

The verification process involves matching newly input minutiae data against registered minutiae data. 
Similar to the registration process, verification requires the capture of a fingerprint image followed by 
extraction of the minutiae data from the captured image into a template. 


Overview of Verification Process 

1. Capture fingerprint image: SGFPM_Getlmage() or SGFPM_GetlmageEx() 

2. Extract minutiae data from captured image: SGFPM_CreateTemplate() 

3. Match newly made template against registered templates: SGFPM_MatchTemplate() 


Adjust the security level according to the type of application. For example, if fingerprint-only 
authentication is used, set the security level higher than SL_NORMAL to reduce false acceptance (FAR). 


Example: Input minutiae data is matched against two registered minutiae data samples 


BYTE* m VrfTemplatel; 

err = SGFPM GetMaxTemplateSize(m hFPM, &m MaxTemplateSize); 
m VrfTemplatel= new BYTE[m MaxTemplateSize]; 

// Get first fingerprint image and create template from the image 
DWORD qlty = 50; 

err = SGFPM GetlmageEx(m hFPM, m ImgBuf, 5000, NULL, qlty); 

err = SGFPM CreateTemplate(m hFPM, 0, m ImgBuf, m VrfTemplatel); 

DWORD si = SL NORMAL; // Set security level depending on 
applications. 

DWORD err; 

BOOL matchedl, matched2; 

err = SGFPM MatchTemplate(m hFPM, m RegTemplatel, m VrfTemplatel, 

si) ; 

err = SGFPM MatchTemplate(m hFPM, m RegTemplate2, m VrfTemplatel, 

si) ; 


if (err == SGSGFDX_ERROR_NONE) 

{ 

if (matchedl && matched2) 

// Matched 
else 

// Not matched 
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3.13. Getting Matching Score 

For improved quality control during the registration or verification process, a matching score can be used 
instead of a security level setting to determine the success of the operation. The matching score can be 
specified so that only sets of minutiae data that exceed the score will be accepted; data below the score 
will be rejected. The matching score may have a value from 0 to 199. SGFPM_GetMatchingScore() 
requires two sets of minutiae data of the same template format. SGFPM_GetMatchingScoreEx() requires 
two sets of minutiae data, but they can take different template formats. For more information about 
template formats, refer to Section 3.15. Template Format . For more information about 
SGFPM_GetMatchingScoreEx(), refer to Section 4.5. Matching Functions . 


DWORD score; 

if (SGFPM GetMatchingScore(m hFPM, m RegTemplatel, m RegTemplatel, 
Sscore) == SGSGFDX_ERROR_NONE) 

{ 

if (score > 100) 

// Enroll these fingerprints to database 
else 

// Try again 

} 


To understand how matching scores correlate with typical security levels, refer to the chart below. For 
more information about security levels, refer to Section 4.5. Matching Functions . 


Security Level vs. Corresponding Matching Score 


Constant 

Value 

Corresponding Matching Score 

SL NONE 

0 

0 

SL LOWEST 

1 

30 

SL LOWER 

2 

50 

SL LOW 

3 

60 

SL BELOW NORMAL 

4 

70 

SLJMORMAL 

5 

80 

SL ABOVE NORMAL 

6 

90 

SL HIGH 

7 

100 

SL H IG H ER 

8 

120 

SL_HIGHEST 

9 

140 
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3.14. Using Auto-On™ 

Auto-On™ is a function that allows the reader to automatically detect the presence of a finger without 
requiring the user to prompt the system before receiving a fingerprint. To use this function, Auto-On 
should be enabled using SGFPM_EnableAutoOnEvent(). Once Auto-On is enabled, the application can 
receive a message from the device driver whenever an Auto-On event occurs in the reader. 


In the UNIX/Linux environment, message queues are used for communication between the device driver 
and the host application. When no finger is present the messages from the driver contain a zero . When a 
finger is present, the driver will send a non-zero value. 


• Enabling Auto-On 


[Example] 

bool StartAutoOn(LPSGFPM m sgfplib) 

{ 

DWORD result; 

bool StartAutoOn = false; 


///////////////////////////////////////////////////////////////// 
// Start Message Queue ////////////////////////////////// 
// Create unique key via call to ftok() 

//Create unique message key 

key = ftok(".", 'a'); //'a' is an arbitrary seed value 

// Open the queue - create if necessary 
if((msg_qid = msgget(key, IPC_CREAT|0660)) == -1) 
return false; 


///////////////////////////////////////////////////////////////// 

// EnableAutoOnEvent(true) 

result = m sgfplib->EnableAutoOnEvent(true,&msg qid,NULL); 
if (result != SGFDX_ERROR_NONE) 

{ 

printf("FAIL - [%ld]\n",result); 

} 

else 

{ 

StartAutoOn = true; 

printf("SUCCESS - [%ld]\n",result); 

} 

return StartAutoOn; 


FDxSDK Pro Programming Manual (UNIX/Linux) 


19 




Chapter 3. Programming in C/C++ 


• Disabling Auto-On 

bool StopAutoOn(LPSGFPM m sgfplib) 

{ 

DWORD result; 

bool StopAutoOn = false; 


///////////////////////////////////////////////////////////////// 

// EnableAutoOnEvent(false) 

result = m sgfplib->EnableAutoOnEvent(false,&msg qid,NULL); 
if (result != SGFDX_ERROR_NONE) 

{ 

printf("FAIL - [%ld]\n",result); 

} 

else 

{ 

StopAutoOn = true; 

printf("SUCCESS - [%ld]\n",result); 

} 


///////////////////////////////////////////////////////////////// 
// Remove Message Queue ///////////////////////////////// 
msgctl(msg qid, IPC RMID, 0); 

return StopAutoOn; 


• Handling Auto-On event in application 

Check for finger presence in a separate thread or a while loop that pops messages from the message 
queue. The following function is an example: 


long fingerPresent() 

{ 

int fingerPresent = 0; 

printf("Reading message queue ...\n"); 

#ifdef _FDU06 

qbuf.mtype = FDU06 MSG; 

#endif 

#ifdef _FDU05 

qbuf.mtype = FDU05 MSG; 
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#endif 

#ifdef FDU04 

qbuf.mtype = FDU04 MSG; 

#endif 

#ifdef _FDU03 

qbuf.mtype = FDU03 MSG; 

#endif 

msgrcv(msg qid, (struct msgbuf *)&qbuf, MAX SEND_SIZE, 
qbuf.mtype, 0); 

if (strlen(qbuf.mtext) > 0) 

{ 

fingerPresent= atol(qbuf.mtext); 

} 

return fingerPresent; 


3.15. Template Format 

The FDx SDK Pro supports three types of fingerprint template formats: 

• SecuGen's proprietary template format ("SG400") 

• ANSI-INCITS 378-2004 "Finger Minutiae Format for Data Exchange" ("ANSI378") 

• ISO/IEC 19794-2:2005 "Biometric Data Interchange Formats- Finger Minutiae Data" ("IS019794- 
2 ") 


As default, SGFPM creates SecuGen proprietary templates (TEMPLATE_FORMAT_SG400). To change the 
template format, use SGFPM_SetTemplateFormat(). 


SG400 templates are encrypted for high security and have a size of 400 bytes. ANSI378 templates are not 
encrypted, and their size is variable depending on how many fingers are registered in the structure and 
how many minutiae points are found. 


For more information about the ANSI378 template, refer to the standard document titled "Information 
technology - Finger Minutiae Format for Data Interchange," document number ANSI-INCITS 378-2004, 
available at the ANSI website http://webstore.ansi.org . 


For more information about the IS019794-2 template, refer to the standard document titled "Information 
technology - Biometric Data Interchange Formats - Part 2: Finger Minutiae Data," document number 
ISO / IEC 19794-2:2005, available at the ISO website under Subcommittee JTC 1 / SC 37 (Biometrics) 

http://www.iso.org/iso/iso catalogue/catalogue tc/catalogue detail.htm?csnumber=38746 . 
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Once the template format is set, it will affect the execution of the SGFPM module. 

The following APIs are affected by SGFPM_SetTemplateFormat(): 
SGFPM_GetMaxTemplateSize() 

SGFPM_CreateTemplate() 

SGFPM_GetTemplateSize() 

SGFPM_MatchTemplate() 

SGFPM_GetMatchingScore() 

The following APIs work only when the template format is TEMPLATE_FORMAT_ANSI378: 
SGFPM_GetTemplateSizeAfterMerge() 

SGFPM_MergeAnsiTemplate() 

SGFPM_MergeMultipleAnsiTemplate() 

SGFPM_GetAnsiTemplatelnfo() 

SGFPM_MatchAnsiTemplate() 

SGFPM_GetAnsiMatchingScore() 

The following APIs work only when the template format is TEMPLATE_F0RMAT_IS019794: 
SGFPM_GetlsoTemplateSizeAfterMerge() 

SGFPM_MergelsoTemplate() 

SGFPM_MergeMultiplelsoTemplate() 

SGFPM_GetlsoTemplatelnfo() 

SGFPM_MatchlsoTemplate() 

SGFPM_GetlsoMatchingScore() 

The following APIs work with any template format: 

SGFPM_MatchTemplateEx() 

SGFPM_GetMatchingScoreEx() 
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• Defining template format 

enum SGFDxTemplateFormat 

{ 

TEMPLATE_F0RMAT_ANSI378 = 0x0100, 

TEMPLATE_FORMAT_SG4 00 = 0x0200, 

TEMPLATE_FORMAT_ISO19 7 9 4 = 0x0300, 

} ; 

• Setting template format to ANSI378 

SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_F0RMAT_ANSI37 8) ; 

• Setting template format to SG400 

SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_FORMAT_SG4 0 0) ; 

• Setting template format to IS019794 

SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_F0RMAT_IS0197 94) ; 


3.16. Manipulating ANSI378 Templates 

The ANSI378 template format allows multiple fingers and multiple views per finger to be stored in one 
template. To support this feature, FDx SDK Pro provides the following special APIs: 


SGFPM_GetTemplateSizeAfterMerge() 

SGFPM_MergeAnsiTemplate() 

SGFPM_MergeMultipleAnsiTemplate() 

SGFPM_GetAnsiTemplatelnfo() 

SGFPM_MatchAnsiTemplate() 

SGFPM_GetAnsiMatchingScore() 


• Merging two ANSI378 templates 

After creating an ANSI378 template from a fingerprint image, additional ANSI378 templates can be 
merged into one template. To do this, use SGFPM_MergeAnsiTemplate(), which takes two ANSI378 
templates and merges them into one template. The merged template size will be less than the sum of the 
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sizes of all input templates. Call SGFPM_GetTemplateSizeAfterMerge() to obtain the exact template size 
of the merged template before using SGFPM_MergeAnsiTemplate(). 


BYTE* m Templatel; 

BYTE* m Template2; 

err = SGFPM GetMaxTemplateSize(m hFPM, &m MaxTemplateSize); 
m Templatel = new BYTE[m MaxTemplateSize]; 
m Template2 = new BYTE[m MaxTemplateSize]; 

// Get first fingerprint image and create template from the image 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, 80); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m Templatel); 

// Get second fingerprint image and create template from the image 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, 80); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m Template2); 

// Save template after merging two templates - m Templatel, 
m Template2 

BYTE* merged template; 

DWORD buf size; 

err = SGFPM GetTemplateSizeAfterMerge(m hFPM, m Templatel, 
m Template2, &buf size); 

merged template = new BYTE [buf size]; 

err = SGFPM MergeAnsiTemplate(m hFPM, m Templatel, m Template2, 
merged_template) ; 

// Save m EnrollTemplate to file 

SaveTemplate(file name, merged template, buf size); 
delete [] merged template; // Freed by calling application 


• Merging multiple ANSI378 templates 

More than two ANSI378 templates may be merged into one template using 
SGFPM_MergeMultipleAnsiTemplate(). The merged template size will be less than the sum of the sizes 
of all source templates. To determine the buffer size for the merged template, use the sum of the size for 
each template and then later obtain the actual size of merged template after calling 

SGFPM_MergeMultipleAnsiTemplate(). 


BYTE* target template; 
DWORD sizel, size2; 
DWORD err; 
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DWORD real_size = 0; 

// Buffer for input templates - source template 

err = SGFPM GetTemplateSize(m hFPM, templatel, &sizel); 

err = SGFPM GetTemplateSize(m hFPM, template2, &size2); 

BYTE* source template = new BYTE [sizel + size2]; // Make stack of 

each template 

memcpy(&source_template[0], templatel, sizel); 
memcpy(&source_template[sizel], template2, size2); 

// Allocate buffer for output template - merged template 
target template = new BYTE[sizel+ size2]; 

err = SGFPM MergeMultipleAnsiTemplate(m hFPM, source template, 2, 
target_template); 

delete [] source_template; 

// Get actual size of merged template 
// Actual size will be less than sizel+size2 

err = SGFPM GetTemplateSize(m hFPM, target template, &real_size); 

• Getting information about an ANSI378 template 

The ANSI378 template format allows multiple fingers and multiple views per finger to be stored in one 
template. To match one sample (view) against a sample in other template, information about the 
template may be needed. To get sample information about a template, use 

SGFPM_GetAnsiTemplatelnfo(). 


DWORD err; 

int matched samples = 0; 

SGANSITemplatelnfo sample infol, sample info2; 

err = SGFPM GetAnsiTemplatelnfo(m hFPM, g EnrollData, 

&sample infol); 

err = SGFPM GetAnsiTemplatelnfo(m hFPM, g VrfData, Ssample info2); 

for (int i = 0; i < sample infol.TotalSamples; i++) 

{ 

for (int j = 0; j < sample info2.TotalSamples; j++) 

{ 

BOOL matched; 

err = SGFPM MatchAnsiTemplate(m hFPM, g EnrollData, i, 
g_VrfData, 0, si, Smatched); 

if (matched) 

matched samples++; 

} 
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if (err == SGFDX_ERROR_NONE) 

{ 

if (matched samples) 

m ResultEdit.Format("Found %d matched samples: 

matched samples); 
else 

m ResultEdit.Format("Cannot find matched sample"); 


else 

m ResultEdit.Format("MatchTemplate() failed. Error = %d " 

err) ; 


3.17. Manipulating IS019794-2 Templates 

The IS019794-2 template format allows multiple fingers and multiple views per finger to be stored in one 
template. To support this feature, FDx SDK Pro provides the following special APIs: 


SGFPM_GetlsoTemplateSizeAfterMerge() 

SGFPM_MergelsoTemplate() 

SGFPM_MergeMultiplelsoTemplate() 

SGFPM_GetlsoTemplatelnfo() 

SGFPM_MatchlsoTemplate() 

SGFPM_GetlsoMatchingScore() 


• Merging two IS019794-2 templates 

After creating an IS019794-2 template from a fingerprint image, additional IS019794-2 templates can be 
merged into one template. To do this, use SGFPM_MergelsoTemplate(), which takes two IS019794-2 
templates and merges them into one template. The merged template size will be less than the sum of the 
sizes of all input templates. Call SGFPM_GetlsoTemplateSizeAfterMerge() to obtain the exact template 
size of the merged template before using SGFPM_MergelsoTemplate(). 


BYTE* m_Templatel; 

BYTE* m_Template2; 

// Set template format to IS019794-2 

err = SGFPM_SetTemplateFormat(m_hFPM, TEMPLATE_F0RMAT_IS019794); 
err = SGFPM GetMaxTemplateSize(m hFPM, &m MaxTemplateSize); 
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m Templatel = new BYTE[m MaxTemplateSize]; 
m Template2 = new BYTE[m MaxTemplateSize]; 

// Get first fingerprint image and create template from the image 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, 80); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m Templatel); 

// Get second fingerprint image and create template from the image 
err = SGFPM GetlmageEx(m hFPM, m_ImgBuf, 5000, NULL, 80); 
err = SGFPM_CreateTemplate(m hFPM, 0, m ImgBuf, m Template2); 

// Save template after merging two templates - m Templatel, 
m Template2 

BYTE* merged template; 

DWORD buf size; 

err = SGFPM GetlsoTemplateSizeAfterMerge(m hFPM, m Templatel, 
m Template2, &buf size); 

merged template = new BYTE[buf size]; 

err = SGFPM MergelsoTemplate(m hFPM, m Templatel, m Template2, 
merged_template); 

// Save m EnrollTemplate to file 

SaveTemplate(file name, merged template, buf size); 
delete [] merged template; // Freed by calling application 


• Merging multiple IS019794-2 templates 

More than two IS019794-2 templates may be merged into one template using 
SGFPM_MergeMultiplelsoTemplate(). The merged template size will be less than the sum of the sizes of 
all source templates. To determine the buffer size for the merged template, use the sum of the size for 
each template and then later obtain the actual size of merged template after calling 

SGFPM_MergeMultiplelsoTemplate(). 


BYTE* target template; 

DWORD sizel, size2; 

DWORD err; 

DWORD real size = 0; 

// Buffer for input templates - source template 

err = SGFPM GetTemplateSize(m hFPM, templatel, &sizel); 

err = SGFPM GetTemplateSize(m hFPM, template2, &size2); 

BYTE* source template = new BYTE[sizel + size2]; // Make stack of 

each template 

memcpy(&source_template[0], templatel, sizel); 
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memcpy(&source_template[sizel], template2, size2); 

// Allocate buffer for output template - merged template 
target template = new BYTE[sizel+ size2]; 

err = SGFPM MergeMultiplelsoTemplate(m hFPM, source template, 2, 
target_template); 

delete [] source_template; 

// Get actual size of merged template 
// Actual size will be less than sizel+size2 

err = SGFPM GetTemplateSize(m hFPM, target template, &real_size); 

• Getting information about an IS019794-2 template 

The IS019794-2 template format allows multiple fingers and multiple views per finger to be stored in one 
template. To match one sample (view) against a sample in other template, information about the 
template may be needed. To get sample information about a template, use 

SGFPM_GetlsoTemplatelnfo(). 


DWORD err; 

BOOL matched = FALSE; 


// IS019794-2 

SGISOTemplatelnfo sample info = {0}; 

err = SGFPM GetlsoTemplatelnfo(m hFPM, m StoredTemplate, 
&sample info); 


matched = FALSE; 

int found finger = -1; 

for (int i = 0; i < sample info.TotalSamples; i++) 


// IS019794-2 


err 

m FetBufM, 0, 


{ 


} 

} 


= SGFPM MatchlsoTemplate(m hFPM, m StoredTemplate, i, 
SL_NORMAL, 

&matched); 

if (matched) 

found finger = sample info.Samplelnfo[i].FingerNumber; 
break; 


if (err == SGFDX_ERROR_NONE) 

{ 

if (found finger >= 0) 


FDxSDK Pro Programming Manual (UNIX/Linux) 


28 


Chapter 3. Programming in C/C++ 


m ResultEdit.Format("The fingerprint data found. Finger 
Position: %s", 

g FingerPosStr[found finger]); 

else 

m ResultEdit.Format("Cannot find matched fingerprint data"); 

} 

else 

{ 

m ResultEdit.Format("MatchlsoTemplate() failed. Error = %d ", 

err) ; 

} 


3.18. Getting Version Information of MINEX Compliant Algorithms 

To obtain version information about the MINEX Compliant algorithms, use SGFPM_GetMinexVersion(). 
Currently, the extractor version number is 0x000A0035, and the matcher version number is 0x000A8035. 


DWORD extractor, matcher; 

err = SGFPM GetMinexVersion(m hFPM, &extractor, Smatcher); 

CString sz ver; 

sz ver.Format("(Extractor:0x%08X, Matcher:0x%08X)", extractor, 
matcher); 

SetWindowText( T("SecuGen ANSI MINEX Test ") + sz ver) ; 


FDxSDK Pro Programming Manual (UNIX/Linux) 


29 


Chapter 4. Function Reference 


Chapter 4. Function Reference 

4.1. SGFPM Creation and Termination 

DWORD SGFPM_Create(HSGFPM* phFPM) 

Creates the SGFPM object internally 


• Parameters 

phFPM: The pointer to contain the handle of the SGFPM object 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_CREATION_FAILED = Failed to create SGFPM object 


SGFPM_Terminate(HSGFPM hFpm) 

Exits the SGFPM module 

• Parameters 

pFPM: The handle of the SGFPM object 

• Return values 

SGFDX ERROR NONE = No error 
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4.2. Initialization 

DWORD SGFPM_lnit(HSGFPM hFpm, DWORD devName) 

Initializes SGFPM with device name information. The SGFPM object loads appropriate drivers with device 
name (devName) and initializes fingerprint algorithm module based on the device information. 

• Parameters 

pFPM: The handle of the SGFPM object 
devName: Specifies the device name 

SG_DEV_FDU03: device name for USB FDU03 and SDU03-based readers 
SG_DEV_FDU04: device name for USB FDU04 and SDU04-based readers 
SG_DEV_FDU05: device name for U20-based USB readers 
SG_DEV_FDU06: device name for UPx-based USB readers 
SG_DEV_FDU07: device name for UlO-based USB readers 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_CREATION_FAILED = Failed to create SGFPM object 
SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX ERROR DRVLOAD FAILED = Failed to load driver 


DWORD SGFPM_lnitEx(HSGFPM hFpm, DWORD width, DWORD height, DWORD dpi) 

Initializes SGFPM with image information. Use when running fingerprint algorithm module without a 
SecuGen reader. 

• Parameters 

pFPM: The handle of the SGFPM object 
width: Image width in pixels 
height: Image height in pixels 
dpi: Image resolution in DPI 
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• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_CREATION_FAILED = Failed to create SGFPM object 
SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_DLLLOAD_FAILED = Failed to load algorithm library 


DWORD SGFPM_SetTemplateFormat(HSGFPM hFpm, WORD format) 

Sets template format. Default format is SecuGen proprietary format (TEMPLATE_FORMAT_SG400). 

• Parameters 

pFPM: The handle of the SGFPM object 
format : Specifies template format 

TEMPLATE_FORMAT_ANSI378: ANSI-INCITS 378-2004 format 
TEMPLATE_FORMAT_SG400: SecuGen proprietary format 
TEMPLATE_FORMAT_ISO 19794: ISO/I EC 19794-2:2005 format 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_CREATION_FAILED = Failed to create SGFPM object 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE: Wrong template format 
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4.3. Device and Capturing Functions 

DWORD SGFPM_EnumerateDevice(HSGFPM hFpm, DWORD* ndevs, SGDeviceList** devList, DWORD 
devName = SG_DEV_UNKNOWN) 

Enumerates currently attached reader to the system. If devName is not specified (SG_DEV_UNKNOWN), 
then it returns a list of all SecuGen readers attached to the system. If devName is specified 
(SG_DEV_FDU03 or SG_DEV_FDU04), it enumerates only the devices that belong to the specified device 
class. 


• Parameters 

pFPM: The handle of the SGFPM object 
ndevs: The number of attached USB readers 

devList: Buffer that contains device ID and device serial number. For more information, see 

Section 5.2. SGDeviceList . 

devName: Device name. Should be one of the following values: 

SG_DEV_UN KNOWN = 0 
SG_DEV_FDU03 = 0x04 
SG_DEV_FDU04 = 0x05 
SG_DEV_FDU05 = 0x06 
SG_DEV_FDU06 = 0x07 

• Returned values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_FUNCTION_FAILED = General function fail error 
SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 


DWORD SGFPM_OpenDevice(HSGFPM hFpm, DWORD devld) 

Initializes the fingerprint reader 

• Parameters 

pFPM: The handle of the SGFPM object 
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devld: Specifies the device ID for USB readers. The value can be from 0 to 9. The maximum number 
of supported readers attached at the same time is 10. 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_SYSLOAD_FAILED = Failed to loading system files 
SGFDX_ERROR_INITIALIZE_FAILED = Failed to initialize chip 
SGFDX ERROR DEVICE NOT FOUND = Device not found 


DWORD SGFPM_CloseDevice(HSGFPM hFpm) 

Closes the opened device. SGFPM_OpenDevice() must be called before this function is used. 

• Parameters 

pFPM: The handle of the SGFPM object 

• Return values 

SGFDX ERROR NONE = No error 


DWORD SGFPM_GetDevicelnfo(HSGFPM hFpm, SGDevicelnfoParam* plnfo) 

Gets device information from the driver (before device initialization) 

• Parameters 

pFPM: The handle of the SGFPM object 

pinfo: A pointer to SGDevicelnfoParam. SGDevicelnfoParam is explained in Chapter 5. Structure 
Reference . 

• Return values 

SGFDX ERROR NONE = No error 
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DWORD SGFPM_Configure(HSGFPM hFpm, HWND hwnd) 

Displays the driver's configuration dialog box 

• Parameters 

pFPM: The handle of the SGFPM object 
hwnd: The parent window handle 

• Return values 

SGFDX ERROR NONE = No error 


DWORD SGFPM_SetBrightness(HSGFPM hFpm, DWORD brightness) 

Controls brightness of image sensor 

• Parameters 

pFPM : The handle of the SGFPM object 
brightness: Must be set to a value from 0 to 100 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 


DWORD SGFPM_SetLedOn(HSGFPM hFpm, bool on) 

Turns optic unit LED on/off 

• Parameters 

pFPM: The handle of the SGFPM object 
on: True: Turns on LED. False: Turns off LED 

• Return values 
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SGFDX ERROR NONE = No error 


DWORD SGFPM_Getlmage(HSGFPM hFpm, BYTE* buffer) 

Captures a 256 gray-level fingerprint image from the reader. The image size can be retrieved by calling 
SGFPM_GetDevicelnfo(). SGFPM_Getlmage() does not check for image quality. To get image quality of a 
captured image, use SGFPM_GetlmageQuality(). To get the approximate image quality while capturing, 

use GetlmageEx(). 


• Parameters 

pFPM: The handle of the SGFPM object 

buffer: A pointer to the buffer containing a fingerprint image. The image size can be retrieved by 
calling GetDevicelnfoQ. 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_WRONG_IMAGE = Capture image is not a real fingerprint image 
SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_LINE_DROPPED = Image data lost 


DWORD SGFPM_GetlmageQuality(HSGFPM hFpm, DWORD width, DWORD height, BYTE* imgBuf, 
DWORD* quality) 

Gets the quality of a captured (scanned) image. The value is determined by two factors. One is the ratio 
of the fingerprint image area to the whole scanned area, and the other is the ridge quality of the 
fingerprint image area. A quality value of 50 or higher is recommended for registration. A quality value of 
40 or higher is recommended for verification. 


Note: The returned quality value is different from the value used in SGFPM_GetlmageEx(). The quality 
value in SGFPM_GetlmageEx() represents only the ratio of the fingerprint image area to the whole 
scanned area. 


• Parameters 

pFPM: The handle of the SGFPM object 
width: Image width in pixels 
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height: Image height in pixels 

imgBuf: Fingerprint image data 

quality: The return value indicating image quality 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 


DWORD SGFPM_GetlmageEx(HSGFPM hFpm, BYTE* buffer, DWORD time = 0, HWND dispWnd , 
DWORD quality) 

Captures fingerprint images from the reader until the quality of the image is greater than the value of the 
quality parameter. The captured fingerprint is a 256 gray-level image; image size can be retrieved by 
calling the SGFPM_GetDevicelnfo() function. A quality value of 50 or higher is recommended for 
registration. A quality value of 40 or higher is recommended for verification. 


Note: The returned quality value is different from the value used in SGFPM_Getlmage(). The quality value 
in GetlmageEx() represents only the ratio of the fingerprint image area to the whole scanned area. 


• Parameters 

pFPM: The handle of the SGFPM object 

buffer: Pointer to buffer containing a fingerprint image 

timeout: The timeout value (in milliseconds) used to specify the amount of time the function will 
wait for a valid fingerprint to be input on the fingerprint reader 

dispWnd: Window handle used for displaying fingerprint images 

quality: The minimum quality value of an image, used to determine whether to accept the 
captured image 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_LINE_DROPPED = Image data lost 

SGFDX_ERROR_TIME_OUT = No valid fingerprint captured in the given time 
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DWORD SGFPM_EnableAutoOnEvent (HSGFPM hFpm, BOOL enable, HWND hwnd, void* reserved) 

Allows the reader to automatically detect the presence of a finger without requiring the user to prompt 
the system before receiving a fingerprint. SGFPM_EnableAutoOnEvent() enables or disables the Auto-On 
function. Once Auto-On is enabled, the application can receive a message from the device driver 
whenever an Auto-On event occurs in the reader. 


When calling SGFPM_EnableAutoOnEvent(), pass the handle of the window that will receive the Auto- 
On message. The Auto-On message is defined as 0x8100 in sgfplib.h. 

• Parameters 

pFPM: The handle of the SGFPM object 
enable: TRUE: enables Auto-On. FALSE: disables Auto-On 
hwnd: Window handle to receive Auto-On message 
reserved: Not used 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 

• Remarks 

When the application receives an Auto-On message, wParam will have event type (Finger ON or OFF) and 
IParam will have information of the device from which the event occurred. 

wParam: Contains event type. 

SGDEVEVNET_FINGER_ON(l) = Finger is on the sensor 
SGDEVEVNET_FINGER_OFF(0) = Finger is removed from the sensor 

IParam: Contains device information. The device information is contained in SGDevicelnfoParam. 
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4.4. Extraction Functions 

DWORD SGFPM_GetMaxTemplateSize(HSGFPM hFpm, DWORD* size) 

Gets the maximum size of a fingerprint template (view or sample). Use this function before using 
SGFPM_CreateTemplate() to obtain an appropriate buffer size. If the template format is SG400, it returns 
fixed length size 400. Note: The returned template size means the maximum size of one view or sample. 

• Parameters 

pFPM: The handle of the SGFPM object 
size: The pointer to contain template size 

• Return values 

SGFDX ERROR NONE = No error 


DWORD SGFPM_CreateTemplate(HSGFPM hFpm, Fingerlnfo* fplnfo, BYTE *rawlmage, BYTE* 
minTemplate) 

Extracts minutiae from a fingerprint image to form a template having the default format 


• Parameters 

pFPM: The handle of the SGFPM object 

fplnfo: Fingerprint information. It is stored in template. For ANSI378 templates, this information 
can be retrieved from the template using GetAnsiTemplatelnfo(). For SG400 templates, this 
information cannot be seen in the template. For more information about the structure, refer to 
section 5.3 SGFingerlnfo . For IS019794 templates, this information can be retrieved from the 
template using GetlsoTemplatelnfo(). 

rawlmg: 256 Gray-level fingerprint image data 

minTemplate: Pointer to buffer containing minutiae data extracted from a fingerprint image 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_FEAT_NUMBER = Inadequate number of minutia 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = 103 = Error while decoding template 1 
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SGFDX_ERR0R_INVALID_TEMPLATE2 = 104 = Error while decoding template 2 


DWORD SGFPM_GetTemplateSize(HSGFPM hFpm, BYTE* minTemplate, DWORD* size) 

Gets template size. If the template format is SG400, it will return 400. If the template format is ANSI378 
or IS019794, template size may vary. 

• Parameters 

pFPM: The handle of the SGFPM object 

minTemplate: Pointer to buffer containing minutiae data extracted from a fingerprint image 
size: The pointer to contain template size 

• Return values 

SGFDX ERROR NONE = No error 


4.5. Matching Functions 

DWORD SGFPM_MatchTemplate(HSGFPM hFpm, BYTE *minTemplatel, BYTE *minTemplate2, DWORD 
secuLevel, BOOL* matched) 

Compares two sets of minutiae data of the same template format. The template format should be the 
same as that set by SGFPM_SetTemplateFormat() and should include only one sample. To match 
templates that have more than one sample, use SGFPM_MatchTemplateEx() or 
SGFPM_MatchAnsiTemplate(). 

It returns TRUE or FALSE as a matching result(matched). Security level(secuLevel) affects matching result. 
The security level may be adjusted according to the security policy required by the user or organization 


• Parameters 

pFPM: The handle of the SGFPM object 

minTemplatel: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

minTempate2: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

secuLevel: A security level as specified in "fplibnew.h" by one the following nine security levels: 
SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL NORMAL, SL_ABOVE_NORMAL, 
SL HIGH, SLJHIGHER and SLJHIGHEST. SLJSIORMAL is recommended in usual case. 
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matched: Contains matching result. Ifpassed templates are same templates, TRUE is returned. If 
not, FALSE is returned. 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_MatchTemplateEx(HSGFPM hFpm, BYTE* minTemplatel, WORD tempateTypel, 
DWORD sampleNuml, BYTE* minTemplate2, WORD tempateType2, DWORD sampleNum2, DWORD 
secuLevel, BOOL* matched) 

Compares two sets of minutiae data, which can be of different template formats (SG400 or ANSI378). It 
returns TRUE or FALSE as a matching result (matched). Security level (secuLevel) affects matching result. 
The security level may be adjusted according to the security policy required by the user or organization. 


• Parameters 

pFPM: The handle of the SGFPM object 

minTemplatel: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

templateTypel: Specifies format of minTemplatel. Should be either TEMPLATE_FORMAT_SG400 
or TEMPLATE_FORMAT_ANSI378. 

sampleNuml : Position of a sample to be matched in minTemplatel. If templateTypel is 
TEMPLATE_FORMAT_ANSI378, it can have a value from 0 to (number of samples -1) in 
minTemplatel. If templateTypel is TEMPLATE_FORMAT_SG400, this value is ignored. 

minTemplate2: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

templateType2: Specifies format of minTemplate2. Should be either TEMPLATE_FORMAT_SG400 
or TEMPLATE_FORMAT_ANSI378. 

sampleNum2: Position of a sample to be matched in minTemplate2. If templateType2 is 
TEMPLATE_FORMAT_ANSI378, it can have a value from 0 to (number of samples -1) in 
minTemplate2. If templateType2 is TEMPLATE_FORMAT_SG400, this value is ignored. 

secuLevel: A security level as specified in "fplibnew.h" by one the following nine security levels: 
SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL NORMAL, SL_ABOVE_NORMAL, 
SL_HIGH, SL_HIGHER, and SLJHIGHEST. SLJSIORMAL is recommended in usual case. 
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matched: TRUE: Same template. FALSE: Not same template 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERR0R_INVAUD_TEMPLATE1 = Error in minTemplatel 
SGFDX_ERR0R_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_GetMatchingScore(HSGFPM hFpm, BYTE* minTemplatel, BYTE* minTemplate2, 
DWORD* score) 

Gets matching score of two sets of minutiae data of the same template format 

• Parameters 

pFPM : The handle of the SGFPM object 

minTemplatel: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

minTemplate2: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

score: Matching score. Returned score has a value from 0 to 199. 

• Returned values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERR0R_INVAUD_TEMPLATE1 = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_ GetMatchingScoreEx(HSGFPM hFpm, BYTE* minTemplatel, WORD tempateTypel, 
DWORD sampleNuml, BYTE* minTemplate2, WORD tempateType2, DWORD sampleNum2, DWORD* 
score); 

Gets matching score of two sets of minutiae data, which can be of different template formats (SG400 or 
ANSI378) 
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• Parameters 

pFPM: The handle of the SGFPM object 

minTemplatel: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

templateTypel: Specifies format of minTemplatel. Should be either TEMPLATE_FORMAT_SG400 
or TEMPLATE_FORMAT_ANSI378. 

sampleNuml: Position of a sample to be matched in minTemplatel. If templateTypel is 
TEMPLATE_FORMAT_ANSI378, it can have a value from 0 to (number of samples -1) in 
minTemplatel. If templateTypel is TEMPLATE_FORMAT_SG400, this value is ignored. 

minTemplate2: A pointer to the buffer containing minutiae data extracted from a fingerprint 
image 

templateType2: Specifies format of minTemplate2. Should be either TEMPLATE_FORMAT_SG400 
or TEMPLATE_FORMAT_ANSI378. 

sampteNum2 : Position of a sample to be matched in minTemplate2. If templateType2 is 
TEMPLATE_FORMAT_ANSI378, it can have a value from 0 to (number of samples -1) in 
minTemplate2. If templateType2 is TEMPLATE_FORMAT_SG400, this value is ignored. 

score: Matching score. Returned score has a value from 0 to 199. 


• Returned values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERR0R_INVAUD_TEMPLATE1 = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 
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4.6. Functions for ANSI378 Templates 

DWORD SGFPM_GetTemplateSizeAfterMerge(HSGFPM hFpm, BYTE* ansiTemplatel, BYTE* 
ansiTemplate2, DWORD* size) 

Calculates template size if two templates - ansiTemplatel and ansiTemplate2 - are merged. Use this 
function to determine exact buffer size before using SGFPM_MergeAnsiTemplate(). 


• Parameters 

pFPM: The handle of the SGFPM object 

ansiTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

ansiTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

size: Template size if two templates are merged 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_MergeAnsiTemplate(HSGFPM hFpm, BYTE* ansiTemplatel, BYTE* ansiTemplate2, 
BYTE* outTemplate) 

Merges two ANSI378 templates and returns a new merged template. The merged template (outTemplate) 
size will be less than sum of the sizes of the two input templates (size of ansiTemplatel + size of 
ansiTemplate2). Call SGFPM_GetTemplateSizeAfterMerge() to determine the exact buffer size for 
outTemplate before calling SGFPM_MergeAnsiTemplate(). 


• Parameters 

pFPM: The handle of the SGFPM object 

ansiTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

asniTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 
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outTempate: The buffer containing merged data. The buffer should be assigned by the 
application. To determine the exact buffer size, call SGFPM_GetTemplateSizeAfterMerge(). 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_MergeMultipleAnsiTemplate(HSGFPM hFpm, BYTE* inTemplates, DWORD 
nTemplates, BYTE* outTemplate) 

Merges multiple ANSI378 templates and returns a new merged template. The merged template 
(outTemplate) size will be less than sum of the sizes of all templates in inTemplates. 


• Parameters 

pFPM: The handle of the SGFPM object 

inTemplates: A series of ANSI378 templates [ANSITemplate-1, ANSITemplate-2, ANSITemplate- 
3, ... ;ANSITemplate-n] 

nTemplates: The number of templates in inTemplates 

outTempate: The buffer containing new merged template data. The buffer should be assigned by 
the application. 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 


DWORD SGFPM_GetAnsiTemplatelnfo(HSGFPM hFpm, BYTE* ansiTemplate, SGANSITemplatelnfo* 
templatelnfo) 

Gets information of an ANSI378 template. Call this function before SGFPM_MatchAnsiTemplate() to 
obtain information about a template. 
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• Parameters 

pFPM: The handle of the SGFPM object 
anisiTemplate: ANSI378 template 

templatelnfo: The buffer that contains template information. For more information see 

SGANSITemplatelnfo structure. 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 


DWORD SGFPM_MatchAnsiTemplate(HSGFPM hFpm, BYTE* ansiTemplatel, DWORD sampleNuml, 
BYTE* ansiTemplate2, DWORD sampleNum2, DWORD secuLevel, BOOL* matched) 

Compares two sets of ANSI378 templates. It returns TRUE or FALSE as a matching result (matched). 
Security level (secuLevel) affects matching result. The security level may be adjusted according to the 
security policy required by the user or organization 


• Parameters 

pFPM: The handle of the SGFPM object 

ansiTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNuml: Position of sample to be matched in ansiTemplatel. It can be from 0 to (number 
of samples -1) in ansiTemplatel 

ansiTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNum2: Position of sample to be matched in ansiTemplate2. It can be from 0 to (number 
of samples -1) in ansiTemplate2 

secuLevel: A security level as specified in "fplibnew.h" by one the following nine security levels: 
SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SLNORMAL, SL_ABOVE_NORMAL, 
SL_HIGH, SL_HIGHER and SL_HIGHEST. SL_NORMAL is recommended in usual case. 

matched: TRUE: Same template. FALSE: Not same template 


• Return values 
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SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in ansiTemplatel 
SGFDX_ERR0R_INVALID_TEMPLATE2 = Error in ansiTemplate2 


DWORD SGFPM_GetAnsiMatchingScore(HSGFPM hFpm, BYTE* ansiTemplatel, DWORD sampleNuml, 
BYTE* ansiTemplate2, DWORD sampleNum2, DWORD* score) 

Gets matching score 


• Parameters 

pFPM: The handle of the SGFPM object 

ansiTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNuml: Position of sample to be matched in ansiTemplatel. It can be from 0 to (number 
of samples -1) in ansiTemplatel 

ansiTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNum2: Position of sample to be matched in ansiTemplate2. It can be from 0 to (number 
of samples -1) in ansiTemplate2 

score: Matching score. Returned score has a value from 0 to 199. 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in ansiTemplatel 
SGFDX_ERRORJNVALID_TEMPLATE2 = Error in ansiTemplate2 
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4.7. Functions for IS019794-2 Templates 

DWORD SGFPM_GetlsoTemplateSizeAfterMerge(HSGFPM hFpm, BYTE* isoTemplatel, BYTE* 
isoTemplate2, DWORD* size) 

Calculates template size if two templates - isoTemplatel and isoTemplate2 - are merged. Use this 
function to determine exact buffer size before using SGFPM_MergelsoTemplate(). 


• Parameters 

pFPM: The handle of the SGFPM object 

isoTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

isoTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

size: Template size if two templates are merged 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_MergelsoTemplate(HSGFPM hFpm, BYTE* isoTemplatel, BYTE* isoTemplate2, BYTE* 
outTemplate) 

Merges two IS019794-2 templates and returns a new merged template. The merged template 
(outTemplate) size will be less than sum of the sizes of the two input templates (size of isoTemplatel + 
size of isoTemplate2). Call SGFPM_GetTlsoemplateSizeAfterMerge() to determine the exact buffer size 
for outTemplate before calling SGFPM_MergelsoTemplate(). 


• Parameters 

pFPM: The handle of the SGFPM object 

isoTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

isoTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 
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outTempate: The buffer containing merged data. The buffer should be assigned by the 
application. To determine the exact buffer size, call SGFPM_GetlsoTemplateSizeAfterMerge(). 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in minTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in minTemplate2 


DWORD SGFPM_MergeMultiplelsoTemplate(HSGFPM hFpm, BYTE* inTemplates, DWORD nTemplates, 
BYTE* outTemplate) 

Merges multiple IS019794-2 templates and returns a new merged template. The merged template 
(outTemplate) size will be less than sum of the sizes of all templates in inTemplates. 


• Parameters 

pFPM: The handle of the SGFPM object 

inTemplates: A series of IS019794-2 templates [ISOTemplate-1, ISOTemplate-2, ISOTemplate-3, 
..., ISOTemplate-n] 

nTemplates: The number of templates in inTemplates 

outTempate: The buffer containing new merged template data. The buffer should be assigned by 
the application. 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 


DWORD SGFPM_GetlsoTemplatelnfo(HSGFPM hFpm, BYTE* isoTemplate, SGISOTemplatelnfo* 
templatelnfo) 

Gets information of an IS019794-2 template. Call this function before SGFPM_MatchlsoTemplate() to 
obtain information about a template. 
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• Parameters 

pFPM: The handle of the SGFPM object 
isoTemplate: IS019794-2 template 

templatelnfo : The buffer that contains template information. For more information see 

SGISOTemplatelnfo structure. 


• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_PARAM = Invalid parameter used 
SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 


DWORD SGFPM_MatchlsoTemplate(HSGFPM hFpm, BYTE* isoTemplatel, DWORD sampleNuml, 
BYTE* isoTemplate2, DWORD sampleNum2, DWORD secuLevel, BOOL* matched) 

Compares two sets of IS019794-2 templates. It returns TRUE or FALSE as a matching result (matched). 
Security level (secuLevel) affects matching result. The security level may be adjusted according to the 
security policy required by the user or organization 


• Parameters 

pFPM: The handle of the SGFPM object 

isoTemplatel : A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNuml : Position of sample to be matched in isoTemplatel. It can be from 0 to (number of 
samples -1) in isoTemplatel 

isoTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNum2: Position of sample to be matched in isoTemplate2. It can be from 0 to (number of 
samples -1) in isoTemplate2 

secuLevel: A security level as specified in "fplibnew.h" by one the following nine security levels: 
SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SLNORMAL, SL_ABOVE_NORMAL, 
SL_HIGH, SL_HIGHER and SL_HIGHEST. SL_NORMAL is recommended in usual case. 

matched: TRUE: Same template. FALSE: Not same template 


• Return values 
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SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in isoTemplatel 
SGFDX_ERROR_INVALID_TEMPLATE2 = Error in isoTemplate2 


DWORD SGFPM_GetlsoMatchingScore(HSGFPM hFpm, BYTE* isoTemplatel, DWORD sampleNuml, 
BYTE*isoTemplate2, DWORD sampleNum2, DWORD* score) 

Gets matching score 


• Parameters 

pFPM: The handle of the SGFPM object 

isoTemplatel: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNuml: Position of sample to be matched in isoTemplatel. It can be from 0 to (number of 
samples -1) in isoTemplatel 

isoTempate2: A pointer to the buffer containing minutiae data. A template can have more than 
one sample. 

sampleNum2: Position of sample to be matched in isoTemplate2. It can be from 0 to (number of 
samples -1) in isoTemplate2 

score: Matching score. Returned score has a value from 0 to 199. 

• Return values 

SGFDX_ERROR_NONE = No error 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Wrong template type 
SGFDX_ERROR_INVALID_TEMPLATEl = Error in isoTemplatel 
SGFDX_ERRORJNVALID_TEMPLATE2 = Error in isoTemplate2 
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4.8. Other 

DWORD SGFPM_GetMinexVersion(HSGFPM hFpm, DWORD *extractor, DWORD* matcher)) 

Gets version of MINEX Compliant algorithms used in this SDK 

• Parameters 

pFPM: The handle of the SGFPM object 

extractor: Version of MINEX Compliant extractor (template generator) 
matcher: Version of MINEX Compliant matcher (template matcher) 

• Return values 

SGFDX ERROR NONE = No error 
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Chapter 5. Structure Reference 


5.1. SG Device Info Pa ram 

typedef struct tagSGDevicelnfoParam 

{ 

DWORD DevicelD; // 0 - 9 

BYTE DeviceSN[SGDEV_SN_LEN+1]; // Device serial number, SN 

length = 15 

DWORD ComPort; // Parallel readers => PP address; USB readers => 

USB (0x3BC+l) 

DWORD ComSpeed; // Parallel readers => PP mode; USB reader => 0 
DWORD ImageWidth; // Image width 
DWORD ImageHeight; // Image height 
DWORD Contrast; // 0 ~ 100 
DWORD Brightness; // 0 ~ 100 
DWORD Gain; // Device dependent 
DWORD ImageDPI; // Image resolution 
DWORD FWVersion; // Firmware version 
} SGDevicelnfoParam; 


Description: Used when calling SGFPM_GetDevicelnfo() 

Members 

• DevicelD: Device ID for USB readers (0 - 9) 

• DeviceSN: Device serial number for USB readers. SGDEV_SN_LEN = 15 

• ComPort: Not used 

• ComSpeed: Not used 

• ImageWidth: Fingerprint image width in pixels 

• ImageHeight: Fingerprint image height in pixels 

• Brightness: Current brightness value (0-100) 

• Contrast: Current contrast value (0-100) 

• Gain: Amplification (1, 2, 4, or 8) of image brightness (higher values yields darker images) 

• ImageDPI: Fingerprint image resolution in DPI 

• FWVersion: Device firmware version number for USB readers 
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5.2. SGDeviceList 

typedef struct tagSGDeviceList 

{ 

DWORD DevName; 

DWORD DevID; 

WORD DevType; 

BYTE DevSN[SGDEV_SN_LEN+1] ; 

} SGDeviceList; 

Description: Used to obtain the currently attached device list in SGFPM_EnumerateDevice() 

Members 

• DevName: Device name (SG_DEV_FDU03 or SG_DEV_FDU04) 

• DevID: Device ID for USB readers 

• DevType: Not used 

• DeviceSN: Device serial number for USB readers (SGDEV_SN_LEN = 15) 


5.3. SGFingerlnfo 

typedef struct tagSGFingerlnfo { 
WORD FingerNumber; 

WORD ViewNumber; 

WORD ImpressionType; 

WORD ImageQuality; 

} SGFingerlnfo; 


Description: Used when calling SGFPM_CreateTemplate(). The provided information will be put into the 
template. For ANSI378 or ISO 19794-2 templates, this information can be seen from the template 
structure format. For SG400 templates, this information cannot be seen in the template. 

Members 


• FingerNumber: Fingerprint position number 
SG_FINGPOS_UK (0x00): Unknown finger 

SG_FINGPOS_RT (0x01): 

SG_FINGPOS_RI (0x02): 

SG_FINGPOS_RM (0x03): 


Right thumb 
Right index finger 
Right middle finger 
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SG_FINGPOS_RR (0x04): 
SG_FINGPOS_RL (0x05): 
SG_FINGPOS_LT (0x06): 
SG_FINGPOS_LI (0x07): 
SG_FINGPOS_LM (0x08): 
SG_FINGPOS_LR (0x09): 
SG_FINGPOS_LL (OxOA): 


Right ring finger 
Right little finger 
Left thumb 
Left index finger 
Left middle finger 
Left ring finger 


Left little finger 
ViewNumber: Sample number for each finger (starts at 0) 
ImpressionType: Impression type (should be 0 for SecuGen readers) 
SG_IMPTYPE_LP (0x00): Live-scan plain 

SG_IMPTYPE_LR (0x01): Live-scan rolled 

SG_IMPTYPE_NP (0x02): Non-live-scan plain 

SG_IMPTYPE_NR (0x03): Non-live-scan rolled 


ImageQuality: Image quality value (0- 100). To get an image quality, use GetlmageQuality(). 


5.4. SGANSITemplatelnfo/SGISOTemplatelnfo 

typedef struct tagSGANSITemplatelnfo { 
DWORD TotalSamples; 

SGFingerlnfo Samplelnfo[225]; 

} SGANSITemplatelnfo, SGISOTemplatelnfo; 


Description: Used when calling SGFPM_GetAnsiTemplatelnfo() or SGFPM_GetlsoTemplatelnfo(). The 

provided information will be put into the template. For ANSI378 templates, this information can be seen 
from the template structure format. For SG400 templates, this information cannot be seen in the 
template. For IS019794-2 templates, this information can be seen from the template structure format. 

Members 

• TotalSamples: Indicates the number of samples in a template. One template can have a maximum 
of 225 samples. 

Number of samples = Max finger number 15 * Max View Number 15 = 225 

• Samplelnfo: Information of each sample in a template. Refer to SGFingerlnfo structure. 
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Chapter 6. Constants 

6.1. SGFDxDeviceName 


Device Name 

Value 

Description 

SG_DEV_UN KNOWN 

0 

Not determined 

SG_DEV_FDU03 

0x04 

FDU03 or SDU03-based reader 

SG_DEV_FDU04 

0x05 

FDU04 or SDU04-based reader 

SG_DEV_FDU05 

0x06 

U20-based reader 

SG_DEV_FDU06 

0x07 

UPx-based reader 

SG_DEV_FDU07 

0x08 

UlO-based reader 


6.2. SGPPPortAddr 


Port Address 

Value 

Description 

AUTO_DETECT 

USB_AUTO_DETECT 

0 

0x3BC+l 

Auto detect 

USB Auto detect 


6.3. SGFDxSecurityLevel 


Security Level 

Value 

Description 

SL_NONE 

0 

No Security 

SL_LOWEST 

1 

Lowest 

SL_LOWER 

2 

Lower 

SL_LOW 

3 

Low 

SL_BELOW_NORMAL 

4 

Below normal 

SL_NORMAL 

5 

Normal 

SL_ABOVE_NORMAL 

6 

Above normal 

SL_H IG H 

7 

High 

SL_H IG H ER 

8 

Higher 

SL_H IG H EST 

9 

Highest 
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6.4. SGFDxTemplateFormat 


Template Format 

Value 

Description 

TEMPLATE_FORMAT_ANSI378 
TEMPLATE_FORMAT_SG400 
TEMPLATE_FORMAT_ISO 19794 

0x0100 

0x0200 

0x0300 

ANSI-INCITS 378-2004 format 
SecuGen proprietary format 

ISO/IEC 19794-2:2005 format 


6.5. SGImpressionType 


Security Level 

Value 

Description 

SG_IMPTYPE_LP 

0x00 

Live-scan plain 

SG_IMPTYPE_LR 

0x01 

Live-scan rolled 

SG_IMPTYPE_NP 

0x02 

Non-live-scan plain 

SG_IMPTYPE_NR 

0x03 

Non-live-scan rolled 


6.6. SGFingerPosition 


Security Level 

Value 

Description 

SG_FINGPOS_UK 

0x00 

Unknown finger 

SG_FINGPOS_RT 

0x01 

Right thumb 

SG_FINGPOS_RI 

0x02 

Right index finger 

SG_FINGPOS_RM 

0x03 

Right middle finger 

SG_FINGPOS_RR 

0x04 

Right ring finger 

SG_FINGPOS_RL 

0x05 

Right little finger 

SG_FINGPOS_LT 

0x06 

Left thumb 

SG_FINGPOS_LI 

0x07 

Left index finger 

SG_FINGPOS_LM 

0x08 

Left middle finger 

SG_FINGPOS_LR 

0x09 

Left ring finger 

SG_FINGPOS_LL 

OxOA 

Left little finger 
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6.7. SGFDxErrorCode 


Error Code 

Value 

Description 

General Error Codes 

SGFDX_ERROR_NONE 

0 

No error 

SGFDX_ERROR_CREATION_FAILED 

1 

SGFPM object creation failed 

SGFDX_ERROR_FUNCTION_FAILED 

2 

Function call failed 

SGFDX_ERROR_INVALID_PARAM 

3 

Invalid parameter used 

SGFDX_ERROR_NOT_USED 

4 

Not used function 

SGFDX_ERROR_DLLLOAD_FAILED 

5 

Library loading failed 

SGFDX_ERROR_DLLLOAD_FAILED_DRV 

6 

Device driver loading failed 

SGFDX ERROR DLLLOAD FAILED ALGO 

7 

Algorithm library loading failed 

Device Driver Error Codes 

SGFDX_ERROR_SYSLOAD_FAILED 

51 

Cannot find driver sys file 

SGFDX_ERROR_INITIALIZE_FAILED 

52 

Chip initialization failed 

SGFDX_ERROR_LINE_DROPPED 

53 

Image data lost 

SGFDX_ERROR_TIME_OUT 

54 

GetlmageEx() timeout 

SGFDX_ERROR_DEVICE_NOT_FOUND 

55 

Device not found 

SGFDX_ERROR_DRVLOAD_FAILED 

56 

Driver file load failed 

SGFDX_ERROR_WRONG_IMAGE 

57 

Wrong image 

SGFDX_ERROR_LACK_OF_BANDWIDTH 

58 

Lack of USB Bandwidth 

SGFDX_ERROR_DEV_ALREADY_OPEN 

59 

Device is already opened 

SGFDX_ERROR_GETSN_FAILED 

60 

Serial number does not exist 

SGFDX ERROR UNSUPPORTED DEV 

61 

Unsupported device 

Extract & Matching Error Codes 

SGFDX_ERROR_FEAT_N UMBER 

101 

Inadequate number of minutiae 

SGFDX_ERROR_INVALID_TEMPLATE_TYPE 

102 

Wrong template type 

SGFDX_ERROR_INVALID_TEMPLATEl 

103 

Error in decoding template 1 

SGFDX_ERROR_INVALID_TEMPLATE2 

104 

Error in decoding template 2 

SGFDX_ERROR_EXTRACT_FAIL 

105 

Extraction failed 

SGFDX_ERROR_MATCH_FAIL 

106 

Matching failed 


6.8. Other Constants 

• SGDEV_SN_LEN 

• WM_APP_SGAUTOON EVENT 

• SGDEVEVNET_FINGER_OFF 

• SGDEVEVNET FINGER ON 


15 // Device serial number length 
0x8100 
0 
1 
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Appendix A. Using SGFPM Objects Directly 


All SDK functions are integrated into the SGFPM class. To access the SGFPM class (not by handle), get the 
pointer of an SGFPM object using CreateSGFPMObject(). When you have finished using the SGFPM object, 
destroy the SGFPM object using DestroySGFPMObject(). 


A.l. Creating an SGFPM object 

To get a pointer to an SGFPM object, use CreateSGFPMObjectQ. To create and use the SGFPM object, it 
should be called. 


SGFPM *g Fpm; // SGFPM object pointer 

DWORD err = CreateSGFPMObject(&g Fpm); 
if (err != SGFDX_ERROR_NONE) 
g_Fpm->Init(SG_DEV_FDU03); 

A.2. Destroying an SGFPM object 

When exiting a program, you must destroy the SGFPM object with DestroySGFPMObject(). 


DestroySGFPMObject(g_Fpm); // Destroys SGFPM object 


A.3. Accessing other member functions 

All member functions are nearly the same as the functions in the C style APIs described in Chapter 3. The 
only difference is that functions are accessed through object pointers, not handles. 


g Fpm->Init(devName); 
g Fpm->InitEx(width, height, dpi); 

g Fpm->SetTemplateFormat (format) // Default format is SG400 
g Fpm->EnumerateDevice(ndevs, devList) 
g Fpm->OpenDevice(devld) 
g Fpm->CloseDevice() 
g Fpm->GetDeviceInfo(pDevicelnfo) 
g Fpm->Configure(hwnd) 
g Fpm->SetBrightness(brightness) 
g Fpm->SetLedOn(onoff) 
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g Fpm->GetImage(buffer) 

g Fpm->GetImageEx(buffer, time = 0, dispWnd, quality) 
g Fpm->GetImageQuality(width, height, imgBuf, quality) 
g Fpm->EnableAutoOnEvent(enable, hwnd, reserved) 
g Fpm->GetMaxTemplateSize(size) 

g Fpm->CreateTemplate(fplnfo, rawlmage, minTemplate) 
g Fpm->GetTemplateSize(buf, size) 

g Fpm->MatchTemplate(minTemplatel, minTemplate2, secuLevel, 

matched) 

g Fpm->GetMatchingScore(mini, min2, score) 

g Fpm->GetTemplateSizeAfterMerge(ansiTemplatel, ansiTemplate2, 

size) 

g Fpm->MergeAnsiTemplate(ansiTemplatel, ansiTemplate2, 

outTemplate) 

g Fpm->MergeMultipleAnsiTemplate(inTemplates, nTemplates, 

outTemplate) 

g Fpm->GetAnsiTemplateInfo(BYTE* ansiTemplate, 

SGANSITemplatelnfo* tempiateInfo) 
g Fpm->MatchAnsiTemplate(ansiTemplatel, sampleNuml, 

ansiTemplate2, sampleNum2, secuLevel, 
matched) 

g Fpm->GetAnsiMatchingScore(ansiTemplatel, sampleNuml, 

ansiTemplate2, sampleNum2, score) 
g Fpm->MatchTemplateEx(minTemplatel, tempateTypel, sampleNuml, 

minTemplate2, tempateType2, sampleNum2, 
secuLevel, matched) 

g Fpm->GetMatchingScoreEx(minTemplatel, tempateTypel, sampleNuml, 

minTemplate2, tempateType2, sampleNum2, 
score) 

g Fpm->GetMinexVersion(extractor, matcher) 

// IS019794-2 

g Fpm->MergeIsoTemplate(isoTemplatel, isoTemplate2, outTemplate) 
g Fpm->MergeMultipleIsoTemplate(inTemplates, nTemplates, 

outTemplate) 

g Fpm->GetIsoTemplateInfo(isoTemplate, templatelnfo) 
g Fpm->MatchIsoTemplate(isoTemplatel, sampleNuml, isoTemplate2, 

sampleNum2, secuLevel, matched) 
g Fpm->GetIsoMatchingScore(isoTemplatel, sampleNuml, 

isoTemplate2, sampleNum2, score) 
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